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“Daylight saving time: Only the government would 
believe that you could cut a foot off the top of a blanket, 
sew it to the bottom, and have a longer blanket.” 
— Or igin Unclear © 2020 Philip Koopman 1] 
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= Anti-Patterns for Date and Time: 
e Daylight saving time hard-coded 
e Time kept without handling time problems 
— Daylight saving time, time zones, mobility 
e Internationalization not considered 
= Date and Time issues 
e Keeping time is tricky 
— Leap years, leap seconds, DST changes 
e Determining and displaying local time is tricky 
— Where are you? Time zone, local DST rules, local display rules 
e Reconciling time is tricky 


— No two computers ever agree EXACTLY on time; updating time has tradeoffs 
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Local time: based on local microcontroller clock rate Botorsre Spy 

/ PRECISION: ee 
e System clock oscillator & timer interrupts > software time g.99_7-59=-93 8 O1L- 
Drift rate: local clock rate vs. perfect time 
e Example, 0.002% is 0.00002 seconds/sec drift rate OFFSETS 
Accuracy: local clock value vs. perfect time 
e Example: Node#2 is 1 second slower than true time 
e Every local clock has a different accuracy 
Offset: difference between two different clocks 
e Example: Node#1 is 3 seconds faster than Node#3 
e Every pair of local clocks has a different offset 
Precision: maximum offset between any two local clocks 


e Example: Node#3 is slowest in system; Node#11 is fastest in | 
system. Precision is their offset = 3 seconds LOCAL TIME 


e There is only one precision value for a system & DRIFT RATE 
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m How do you fix an incorrect clock? 
e Typically only periodic access to clock server 
e State correction 
— Fast forward/reverse to correct time 
— Time jumps or even flows backwards 
e Rate correction 
— Speed up/slow down local tick rate 
— Rate of time is slightly incorrect for a while 








= Network Time Protocol (NTP) 
e Time maintenance service 
— Uses Internet access to estimate and track time 
e Complex, and behavior depends upon options 
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Time Zones & Daylight Saving Time 


Please click a time zone 
— 






= Original time zones for UK rail schedules 
e Not necessarily whole hours 


= DST changes arbitrary via governments 
e WWII permanent DST (“War Time’) 
e Arizona does not observe DST 
— Navajo reservation within Arizona does DST ene ge 


— Hopi reservation does not do DST K 


RS _BUUTAN, 
= DST Dates differ by location | Nw? SATs 
e US and Europe differ since 2007 Oo (59/7 Prnciabesiyy 


— i Bn 


MAYS | CX 


https://goo.gl/KuWhMB 


—- Europe to discontinue DST in 2021 | 
e Northern vs. Southern hemisphere: \Z.¢..37 
— Fall and Spring are reversed! SPRING 
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Types of time: 
e Solar time: Based on mean sun position 
e Local time: Time in your time zone 


e GMT: Greenwich Mean Time / time zone zero 
— Official time is Universal Coordinated Time (UTC) 





Sunrise/Sunset depends on where you are 
e Sunrises earlier at eastern end of time zone i, (rong ar 
e Depends upon latitude & longitude * iy a9 fh pa game “ata 
- Sun angle, length of day (including “midnight sun”) 2% are a0: i one, » e 
— Length of day increases slightly with altitude Re — 
e “Mean Sun” differs from actual sun fr. “ 
—- Depends on date and year 
— “Equation of time” calculation 
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Mobility and Time yee 
= Time depends upon your location TW] al. 

e Whattime is it? Which event happened earlier? il t — 
= Date line (+1 day in Asia) ~ | 
e Itis very far from a straight line; and it changes | pe a 
= Potential issues: \- 

e System with multiple users in different time zones 
e System moves between time zones ois 
— While powered on; while powered off aa 
e What if system is turned off during DST change? 
- Common bug: fall back too many times for Fall DST ae Se ¥ 
= Best practice: keep time with GMT/UTC a f=) = 
e Keep time globally in GMT/UTC — | "| ge 
e Display time locally (add in effects of DST, time zones) 
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Leap years: about 365.25 days/year 


February 29th is leap day every 4 years, ... 
— except every 100 years, ... 

» except every 400 years 
— 1900, 2100 are NOT leap years 

» 2000 was a leap year 


Leap seconds added to UTC: 


Earth's rotation is not constant 
Every once in a while, an extra second is inserted: 





theguardian Jan. 1, 2009 


Zune bricking code uncovered: it's a leap 
year mistake, and not Microsoft's 


The flaw that made Zunes freeze has been tracked down, it seems, to a piece of 
bad programming emanating from Freescale (the semiconductor company spun 
off from Motorola). 
Simply put, there was a loop to allow for leap years (as 2008 was). However, it 
didn't have any way to get past the beginning of the 366th day of the year. 

See a See | 


year = ORIGINYEAR; /* = 1980 */ 


~ 61 second minute: 23:59:00, .., 23:59:59, 23:59:60, 00:00:00 (+1day) while (days > 365) 


- Theoretically could have negative leap second 


Local rule changes can cause time leaps 


Time rollovers can appear as a huge backward leap 
e Y2K/Millenium Bug: 99 = 00 rollover on 2-digit years 


Changing time zone of a location 


Unix cron rollover: 03:14:07 UTC on 19 January 2038 


{ if (IsLeapYear(year)) 
{ if (days > 366) 
{ days -= 366; year += 1; 
\ // MISSING ELSE! 
1 else 
{ days -= 365; year += 1; 
} 
} 
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Internationalization yo we 
m What day is 02/03/16? ZG AN 
a Na Eee 


e US: Feb 3, 2016; Europe: 2 March 2016; or 1916? 





— What day does a week start on? (Sunday or Monday?) 





f7ds—t eee 


e Mapping to traditional Chinese Lunisolar calendar? _— hell TORE wy 


= Example internationalization issues: 






—- Complete with Leap Month(s) 


hesicrers | TTDI 
Yh = | |e het | 
ist mi = plese” 








AM/PM vs. 24 hour clock 
English vs. Metric (F/C, ft/meter, mph/kph, miles/km, ‘ NEN 
Currency signs, numeric notation (decimal vs. comma) 
Character sets (e.g. ASCII vs. unicode), word lengths 
Keyboard data entry (e.g., ASCII vs. Asian character entry vs. Arabic) 
Left to right, right to left, top to bottom text flow 


Gender in language, gender identification 
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Time Best Practices 


=m Use validated time-keeping libraries 
e |t is complicated to get this right 
e Need a way to change DST, time zones, etc. 
e Consider mobility & multi-site coordination 





= Think through internationalization 
e What do you support/not support? 


= Pitfalls: 


@ 
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... THEN, AFTER OUR DRONES TAKE CONTROL 
OF THE CINES, WE. WILL DETONATE. THE 
DEVICES. CALIFORNIA WILL BREAK OFF FROM 
THE MAINLAND AND DRIFT OUT TO SEA! 


HOW FAK OUT TO SEA? WILL IT PUT ANY 
OF THE CITIES IN THE UTC-7 TIME ZONE? 


WHAT? LDONT KNOW. 


ONE REQUEST: CAN WE MAKE SURE 
THIS DOESNT HAPPEN DURING THE 
DAYLIGHT SAVING CHANGEOVER? 


‘96 


TF tte com 1889) 


YOU CAN TELL WHEN SOMEONE'S BEEN A 
PROGRAMMER FOR A WHILE BECAUSE THEY DEVELOP 
A DEEP-SEATED FEAR OF TIME ZONE. PROBLEMS. © 2020 Philip Koopman 11 





